home *** CD-ROM | disk | FTP | other *** search
Text File | 1991-10-03 | 41.9 KB | 1,333 lines |
- ; ------------------------ MEMOPAD.TXT ---------------------
- ;
- ; This is the help text file for the MEMOPAD application. It
- ; includes the help text that a D-Flat application would use
- ; for the user interface.
- ;
- ; There can be a help window with a helptag name for each
- ; command in commands.h, each menu label on the menu bar
- ; as defined in menus.c, and each dialog box name in dialogs.c
- ;
- ; There can be other help windows as well. Some of them will
- ; be displayed as the result of hypertext and definition key
- ; words embedded in the help text of other help windows. Others
- ; can be implemented from within an application software system.
- ;
- ; Following is the format for a help window:
- ;
- ; ┌── (1st column of each line)
- ;
- ; ; anything with a semicolon in the 1st column is a comment
- ; <helptag> (names the help window)
- ; [<<]<helptag> (names the previous window in chain)
- ; [>>]<helptag> (names the next window in chain)
- ; Help Window Title (displays in window's title bar)
- ; Help text follows until next helptag occurs
- ; Hypertext reference [..keyword]<helptag> embedded in text
- ; Definition reference [**keyword]<helptag> embedded in text
- ; <helptag> (names another window)
- ;
- ; Notes:
- ; 1. A hypertext reference, when selected, causes the
- ; associated help window named by the <helptag> to
- ; become the active help window.
- ; 2. A definition reference, when selected, displays
- ; a momentary window with the text of the associated
- ; help window named by the <helptag>. The window
- ; closes when the user releases the Enter key or
- ; mouse button.
- ; 3. A definition window has no title.
- ; 4. The last window is followed by the <end> helptag.
- ; 5. The window's height and width adjust to the text.
- ; 6. The [..], [**], and <helptags> do not display and
- ; do not figure in the width of the line in which
- ; they occur.
- ;
- ; -----------------------------------------
- <Application>
- [<<]<MEMOPAD>
- [>>]<Menubar>
- Application Window
- The Application Window is the desktop for the
- application.
-
- The Application window contains the application's
- [..Document Windows]<docwindow>. Before you open any documents,
- the Application window is empty.
-
- The application window has an [..Action Bar]<Menubar> just below
- its [..Title Bar]<titlebar> and a [..Status Bar]<statusbar> at the bottom.
-
- Note that there might not be a title or status bar
- depending on the [..Display]<ID_DISPLAY> option on the [..Options]<Options>
- menu.
- ; -----------------------------------------
- <MEMOPAD>
- [>>]<Application>
- The MEMOPAD Application
- MEMOPAD is a multi-window notepad program that
- demonstrates the programmer's [**API]<API> to the D-Flat
- Common User Access interface library.
- ; -----------------------------------------
- <MEMOPADDOC>
- [<<]<Application>
- The MEMOPAD Document Window
- This [..Document Window]<docwindow> is a basic notepad text editor. You can
- have many of these windows open at one time.
- ; -----------------------------------------
- <docwindow>
- Document Window
- A Document Window contains the data that you work
- on. It displays within the [..Application Window]<Application> and
- consists of these parts:
-
- [..Client Area]<client>
- [..Border]<border>
- [..Title Bar]<titlebar>
- [..Status Bar]<statusbar>
- [..Scroll Bars]<scrollbar>
- [..Control Box]<controlbox>
- [..Minimize Box]<minbox>
- [..Maximize Box]<maxbox>
- [..Restore Box]<restorebox>
- [..Resize Box]<sizebox>
-
- ; -----------------------------------------
- <client>
- [<<]<docwindow>
- [>>]<border>
- Client Area
- The Client Area is the space inside the window's
- borders where the application's data values are
- displayed and manipulated.
- ; -----------------------------------------
- <border>
- [<<]<client>
- [>>]<titlebar>
- Border
- The Border is the frame around a window. When the
- window has the focus, the border is a double line.
- When a different window has the focus, the border
- is a single line.
-
- The window's [..Scroll Bars]<scrollbar>, if any, are positioned
- in the right and bottom parts of the border.
- ; -----------------------------------------
- <titlebar>
- [<<]<border>
- [>>]<statusbar>
- Title Bar
- The Title Bar is at the top of the window and
- contains the window's title. When the window
- has the focus, the title is highlighted. The
- Title Bar includes these items as well:
-
- [..Control Box]<controlbox>
- [..Minimize Box]<minbox>
- [..Maximize Box]<maxbox>
- [..Restore Box]<restorebox>
-
- You can move the window with the mouse by clicking
- the title bar and dragging the window to its new
- location.
- ; -----------------------------------------
- <statusbar>
- [<<]<titlebar>
- [>>]<scrollbar>
- Status Bar
- The Status Bar is at the bottom of the application window.
- It displays the time and brief contextual messages about
- the menus and other application-dependent features.
- ; -----------------------------------------
- <scrollbar>
- [<<]<statusbar>
- [>>]<controlbox>
- Scroll Bars
- You use Scroll Bars to scroll a window's data with the
- mouse. A window can have one or two Scroll Bars - one
- at the right and one at the bottom parts of the
- window's Border. The Scroll Bar at the right scrolls
- the document's data up and down. The Scroll Bar on
- the bottom scrolls the window's data right and left.
-
- To scroll a window a line at a time, click the arrow
- tokens at either end of the Scroll Bar. The Scroll Bar
- includes a slider box that indicates the relative
- position of the window's display with respect to the
- total document. You can page to an approximate position
- within the document by clicking inside the Scroll Bar.
- You can drag the slider box in either direction to
- scroll the document.
- ; -----------------------------------------
- <controlbox>
- [<<]<scrollbar>
- [>>]<minbox>
- Control Box
- The Control Box is indicated by the character (≡) at
- the left end of the window's [..Title Bar]<titlebar>. You can
- click it to select the System Menu or double click
- it to close the window.
- ; -----------------------------------------
- <minbox>
- [<<]<controlbox>
- [>>]<maxbox>
- Minimize Box
- The Minimize Box is the token at the right
- end of the window's [..Title Bar]<titlebar>.
-
- When you click on the Minimize Box, the window
- is reduced to an icon at the bottom of the
- [..Application Window]<Application>
- ; -----------------------------------------
- <maxbox>
- [<<]<minbox>
- [>>]<restorebox>
- Maximize Box
- The Maximize Box is the token at the right
- end of the window's [..Title Bar]<titlebar>.
-
- When you click on the Maximize Box, the window
- grows to occupy the entire [..Client Area]<client> of the
- [..Application Window]<Application>
- ; -----------------------------------------
- <restorebox>
- [<<]<maxbox>
- [>>]<sizebox>
- Restore Box
- The Restore Box is the token character at the right
- end of a minimized window's [..Title Bar]<titlebar> and the token
- character at the right end of a maximized window's
- Title Bar. You click the Restore Box to restore the
- window to the position and size it had before it was
- minimized or maximized.
- ; -----------------------------------------
- <sizebox>
- [<<]<restorebox>
- Resize Box
- The Resize Box is the lower right corner of the
- window's border. To change the window's size,
- drag the Resize Box. The window's upper left
- coordinates remain the same, and the lower right
- coordinates change as you drag the mouse around.
- ; -----------------------------------------
- <Menubar>
- [<<]<application>
- [>>]<Pulldowns>
- The Action Bar
- To select the action bar, do one of these:
- 1. Press F10
- 2. Press and release the Alt key
- 3. Press Alt+the letter that is highlighted
- in a menu's title on the action bar. The
- selected menu will pull down.
- 4. Click the action bar. If you click a
- pull-down menu selection's title, that
- menu will pull down.
-
- To exit from the action bar and return to the
- document or application window, do one of these:
- 1. Press Esc
- 2. Press and release the Alt key
- ; -----------------------------------------
- ;
- ; Following are the Help system windows
- ;
- ; -----------------------------------------
- <HelpHelp>
- [<<]<Help>
- [>>]<ExtHelp>
- Help for Help
- Getting Into the Help System
- ----------------------------
- There are three ways to get into the Help system:
-
- 1. Execute commands on the [..Help]<Help> menu
- 2. Press F1
- 3. Press the Help command button on a dialog box.
-
- Contextual Help (F1)
- --------------------
- The F1 key provides contextual help--help for the
- part of the application that currently has the
- focus. You can press F1 with the action bar selected,
- a pull-down menu displayed, a field on a dialog box
- selected, or a document window in focus.
-
- The Help Command Button
- -----------------------
- The Help command button on a dialog box displays
- information about the dialog box and its purpose.
- The help window that displays when you press F1 with
- a dialog box field selected relates to the field
- itself.
-
- References to Other Help Windows
- --------------------------------
- A Help window can include a reference to another
- help window. That reference is highlighted like
- this:
-
- [..Help]<Help>
-
- You can Tab to the highlighted reference and press
- the Enter key to select the referenced help window.
- You can select it with the mouse by double-clicking
- on it.
-
- Definitions
- -----------
- Some references, such as [**function key]<shortcut>, are
- definitions of terms. These definitions are
- highlighted the same as references. When you select
- the definition, a window displays in the upper left
- corner of the desktop. The window contains the
- definition of the selected term and stays in view
- until you release the Enter key or the mouse
- button.
-
- Command Buttons on the Help Windows
- -----------------------------------
- Each help window contains these [..command buttons]<cmdbuttons>:
-
- Close This button closes the help window and
- exits from the help system.
- Back This button changes to the help window
- that you viewed before the current one.
- Prev This button changes to the help window
- that logically preceeds the current one.
- Next This button changes to the help window
- that logically follows the current one.
-
- Exiting from the Help System
- ----------------------------
- You exit from the Help system by closing the current
- help window in one of these three ways:
-
- 1. Press the Esc key
- 2. Use the Close command button on the Help
- window.
- 5. Double click the window's [..Control Box]<controlbox>.
- 4. Close the help window from its [..System Menu]<sysmenu>.
-
- ; -----------------------------------------
- <ExtHelp>
- [<<]<HelpHelp>
- [>>]<KeysHelp>
- Extended Help
- The MEMOPAD program has few features and procedures
- that are not taken directly from the SAA/CUA
- interface that F-Flat implements. The [..Log Messages]<ID_LOG>
- and [..Display]<ID_DISPLAY> selections on the [..Options]<Options> menu are
- unique to MEMOPAD and would not necessarily be in
- an application. Some of the Display features would
- be useful to a user who is not developing D-Flat
- programs. Others, such as the [..Title]<ID_TITLE>, [..Border]<ID_BORDER>,
- [..Status Bar]<ID_STATUSBAR>, and [..Texture]<ID_TEXTURE> check boxes on the [..Display]<Display?GA>
- dialog box, are to allow a programmer to see how
- the screen looks with these features enabled and
- disabled.
- ; -----------------------------------------
- <KeysHelp>
- [<<]<ExtHelp>
- [>>]<HelpIndex>
- Keys Help
- From the Desktop
- ----------------
- Alt+Hyphen Open the desktop's [..SystemMenu]<sysmenu>.
- F10 or Alt Activate the [..ActionBar]<menubar>.
- Esc Deactivate the Action Bar.
- Alt+letter Open the associated [..Pull-down menu]<Pulldowns>.
- Alt+F6 Change focus to another document.
- Alt+X Exit the application.
-
- From a [..Document Window]<docwindow>
- ----------------------
- Alt+Spacebar Open the window's [..System Menu]<sysmenu>
- Alt+S Save the document to a disk file.
-
- Editor Keys
- -----------
- Arrow keys Move the cursor one character.
- Ctrl+arrow Move the cursor one word.
- Del Delete character to the right of
- the cursor. If a [..block]<Block> is marked,
- delete the block.
- Backspace Delete character to the left of
- the cursor. If a block is marked,
- delete the block.
- Alt+BackSpace Undo the last block deletion.
- PgUp/PgDn Scroll forward and back one page.
- Ctrl+PgUp/PgDn Scroll horizontally one page.
- Home/End Move the cursor to the beginning
- and end of the line.
- Ctrl+Home/End Move the cursor to the beginning
- and end of the document.
- Alt+P Form a paragraph from the marked
- block. If no block is marked, form
- a paragraph from the cursor
- position to the next blank line.
- Ins Toggle Insert/Overstrike mode.
- Tab Tab to the next [..Tab Stop]<TabStops> position.
-
- [..Clipboard]<clipboard> Keys
- --------------
- Shift+Del [..Cut]<ID_CUT> the marked text to the
- Clipboard
- Ctrl+Ins [..Copy]<ID_COPY> the marked text to the
- Clipboard.
- Shift+Ins [..Paste]<ID_PASTE> the contents of the
- Clipboard into the document.
-
- [..Dialog Box]<dialog> Keys
- ---------------
- Tab Move to the next control.
- Shift+Tab Move to the previous control.
- Enter Execute the control.
- Esc Close the Dialog Box with no
- action.
-
- [..Listbox]<listbox> Keys
- ------------
- Up/down arrows Move the selection cursor
- Ctrl+arrows Select a group of entries.
- Enter Choose the selected entry
- or entries.
- Shift+F8 Toggle Add mode.
- Spacebar In Add mode, select/deselect an
- entry.
- ; -----------------------------------------
- <HelpIndex>
- [<<]<KeysHelp>
- Index of Help Titles
- Select (Tab then Enter or double-click) from these
- titles to view the help screens related to each one.
-
- [..Application Window]<Application>
- [..Action Bar]<Menubar>
- [..Pull-down Menus]<Pulldowns>
- [..The File Menu]<File>
- [..The Edit Menu]<Edit>
- [..The Search Menu]<Search>
- [..The Options Menu]<Options>
- [..The Window Menu]<Window>
- [..The Help Menu]<Help>
- [..Dialog Boxes]<Dialog>
- [..The File Open Dialog Box]<FileOpen>
- [..The Save As Dialog Box]<SaveAs>
- [..The MsgBox Dialog Box]<MsgBox>
- [..The Display Dialog Box]<Display>
- [..The TabStops Dialog Box]<TabStops>
- [..The Windows Dialog Box]<Windows>
- [..The Log Dialog Box]<Log>
- [..The Help System]<Help>
- [..Help for help...]<ID_HELPHELP>
- [..Extended help...]<ID_EXTHELP>
- [..Keys help...]<ID_KEYSHELP>
- [..Help index...]<ID_HELPINDEX>
- [..Reload Help Database]<ID_LOADHELP>
-
- ; -----------------------------------------
- ;
- ; Following are menu command help windows
- ;
- ; -----------------------------------------
- <ID_NEW>
- [<<]<File>
- [>>]<ID_OPEN>
- The New Command
- This command opens a new, untitled document
- window. An untitled document is one that has
- not been given a file name. When you use the
- [..Save]<ID_SAVE> or [..Save as]<ID_SAVEAS> command on the File menu the
- document gets a file name.
- ; -----------------------------------------
- <ID_OPEN>
- [<<]<ID_NEW>
- [>>]<ID_SAVE>
- The Open Command
- This command opens an existing document and loads
- it into a window. You select the document by filling
- in the [..File Open]<FileOpen> dialog box.
- ; -----------------------------------------
- <ID_SAVE>
- [<<]<ID_OPEN>
- [>>]<ID_SAVEAS>
- The Save Command
- This command saves the document in the currently
- active document window into a disk file. The file
- name is the same as when the file was loaded. If
- the window contains an untitled document, this
- command works just like the [..Save as]<ID_SAVEAS> command.
- ; -----------------------------------------
- <ID_SAVEAS>
- [<<]<ID_SAVE>
- [>>]<ID_DELETEFILE>
- The Save As Command
- This command allows you to save the document in the
- currently active document window under a new file
- name. You specify the file's name by filling in the
- fields on the [..Save as]<SaveAs> dialog box.
-
- The new file name becomes the title of the
- currently active document window where the file is
- displayed.
- ; -----------------------------------------
- <ID_DELETEFILE>
- [<<]<ID_SAVEAS>
- [>>]<ID_PRINT>
- The Delete Command
- Use this command to delete the text file displayed
- in the active editbox window.
- ; -----------------------------------------
- <ID_PRINT>
- [<<]<ID_DELETEFILE>
- [>>]<ID_DOS>
- The Print Command
- This command prints the document in the
- currently-selected document window.
- ; -----------------------------------------
- <ID_DOS>
- [<<]<ID_PRINT>
- [>>]<ID_EXIT>
- The DOS Command
- This command "shells" out to DOS. You return to the
- application from DOS by executing the DOS exit
- command at the DOS command line.
- ; -----------------------------------------
- <ID_EXIT>
- [<<]<ID_DOS>
- The Exit Command
- This command exits to DOS from the application. If
- there are any changed documents that you have not
- saved, the program will ask if you want to save
- them and allow you to do so, one at a time.
- ; -----------------------------------------
- <ID_UNDO>
- [<<]<Edit>
- [>>]<ID_CUT>
- The Undo Command
- This command "undoes" the most recent [..Delete]<ID_DELETETEXT> or
- [..Clear]<ID_CLEAR> command. The text that was deleted by one of
- these commands is written into the document at the
- current cursor location.
- ; -----------------------------------------
- <ID_CUT>
- [<<]<ID_UNDO>
- [>>]<ID_COPY>
- The Cut Command
- This command is active only when the current
- document window has a [..marked block]<Block>. The command
- deletes the text in the marked block, copies it to
- the [..Clipboard]<Clipboard>, and closes up the space in the
- document that the text previously occupied.
- ; -----------------------------------------
- <ID_COPY>
- [<<]<ID_CUT>
- [>>]<ID_PASTE>
- The Copy Command
- This command is active only when the current
- document window has a [..marked block]<Block>. The command
- copies the text in the marked block to the
- [..Clipboard]<Clipboard>, and closes up the space in the document
- that the text previously occupied.
- ; -----------------------------------------
- <ID_PASTE>
- [<<]<ID_COPY>
- [>>]<ID_CLEAR>
- The Paste Command
- This command is active only when the [..Clipboard]<Clipboard>
- contains text. The command inserts the text from the
- Clipboard into the currently active document window
- at the current cursor location.
- ; -----------------------------------------
- <ID_CLEAR>
- [<<]<ID_PASTE>
- [>>]<ID_DELETETEXT>
- The Clear Command
- This command is active only when the current
- document window has a [..marked block]<Block>. The command
- deletes the block of text, leaving empty space in
- the document where the text had been.
-
- You can undo the text deletion with the
- [..Undo]<ID_UNDO> command.
- ; -----------------------------------------
- <ID_DELETETEXT>
- [<<]<ID_CLEAR>
- [>>]<ID_PARAGRAPH>
- The Delete Command
- This command is active only when the current
- document window has a [..marked block]<Block>. The command
- deletes the block of text, closing the space in the
- document where the text had been.
-
- You can undo the text deletion with the
- [..Undo]<ID_UNDO> command.
- ; -----------------------------------------
- <ID_PARAGRAPH>
- [<<]<ID_DELETETEXT>
- The Paragraph Command
- This command reforms a paragraph beginning at the
- current keyboard cursor position. The end of the
- paragraph is the last line preceding the next blank
- line.
-
- If a [..marked block]<Block> is defined, the
- Paragraph command forms a new paragraph from the
- block without regard to the cursor position.
- ; -----------------------------------------
- <ID_SEARCH>
- [<<]<Search>
- [>>]<ID_REPLACE>
- The Search Command
- This command opens the [..Search Text]<SearchText> Dialog Box to
- allow you to search the text for a
- matching string.
- ; -----------------------------------------
- <ID_REPLACE>
- [<<]<ID_SEARCH>
- [>>]<ID_SEARCHNEXT>
- The Replace Command
- This command opens the [..Replace Text]<ReplaceText> Dialog Box to
- allow you to search the text for a
- matching string and replace it with a
- different text string.
- ; -----------------------------------------
- <ID_SEARCHNEXT>
- [<<]<ID_REPLACE>
- The Next Command
- This command continues the most recent [..Search]<ID_SEARCH>
- command beginning at the current cursor position.
- ; -----------------------------------------
- <ID_INSERT>
- [<<]<Options>
- [>>]<ID_WRAP>
- The Insert Toggle
- This [**toggle]<toggle> command turns the editor's insert mode
- on and off. When insert mode is on, the editor
- inserts the text that you write. Otherwise each
- character typed overwrites the one at the current
- cursor position.
- ; -----------------------------------------
- <ID_WRAP>
- [<<]<ID_INSERT>
- [>>]<ID_TABS>
- The Word Wrap Toggle
- This [**toggle]<toggle> command turns the editor's word wrap
- feature on and off. When word wrap is on, the editor
- will wrap words as you type at the right margin of
- the document window. When word wrap is off, the
- editor will scroll the display horizontally as you
- type beyond the right margin.
- ; -----------------------------------------
- <ID_TABS>
- [<<]<ID_WRAP>
- [>>]<ID_DISPLAY>
- The Tabs Command
- This command displays the [..Editor Tab Stops]<TabStops> dialog
- box so that you can change the editor's tab
- settings.
- ; -----------------------------------------
- <ID_DISPLAY>
- [<<]<ID_TABS>
- [>>]<ID_LOG>
- The Display Command
- This command displays the [..Display]<Display?GA> dialog box to
- allow you to modify the screen's colors and
- configuration.
- ; -----------------------------------------
- <ID_LOG>
- [<<]<ID_DISPLAY>
- [>>]<ID_SAVEOPTIONS>
- The Log Messages Command
- This command is used primarily for debugging. It
- opens the [..Log Message]<Log> dialog box to allow the
- programmer to select the D-Flat messages to log and
- to turn message logging on and off.
- ; -----------------------------------------
- <ID_SAVEOPTIONS>
- [<<]<ID_LOG>
- The Save Options Command
- This command saves the current options in a
- configuration file that the application reads when
- it first starts up.
- ; -----------------------------------------
- <ID_CLOSEALL>
- [<<]<Window>
- [>>]<ID_WINDOW>
- The Close All Command
- This command closes all the document windows on the
- desktop.
- ; -----------------------------------------
- <ID_WINDOW>
- [<<]<ID_CLOSEALL>
- The Open Window List
- The [..Window]<Window> menu displays a list of open document
- windows. You can select one of them as the current
- active window by selecting its title on the Window
- menu. When the menu first displays, the active
- window has a check mark (√) next to it.
- ; -----------------------------------------
- <ID_HELPHELP>
- [<<]<Help>
- [>>]<ID_EXTHELP>
- Help for Help
- This command describes how to use the Help system.
- ; -----------------------------------------
- <ID_EXTHELP>
- [<<]<ID_HELPHELP>
- [>>]<ID_KEYSHELP>
- Extended Help
- Extended Help displays information about the
- application.
- ; -----------------------------------------
- <ID_KEYSHELP>
- [<<]<ID_EXTHELP>
- [>>]<ID_HELPINDEX>
- Keys Help
- This command displays a help window that shows the
- keystrokes that you use to operate the application.
- ; -----------------------------------------
- <ID_HELPINDEX>
- [<<]<ID_KEYSHELP>
- [>>]<ID_LOADHELP>
- Help Index
- The Help index lists the subjects covered in the
- Help database. You can go directly to a subject from
- the index by selecting the subject's name.
- ; -----------------------------------------
- <ID_LOADHELP>
- [<<]<ID_HELPINDEX>
- [>>]<ID_ABOUT>
- Reload Help Database
- This command allows you to reload the Help
- database. It is useful when you use the
- Memopad program to modify its Help database.
- You can change and save the MEMOPAD.TXT file,
- use this command to reload it, then use the
- Help system to view the results. Without this
- command, your changes would corrupt the
- current Memopad's picture of the database
- with respect to its pointers.
-
- You must delete the MEMOPAD.HLP compressed
- help database in order for this program to
- load the most recent changes.
- ; -----------------------------------------
- <ID_ABOUT>
- [<<]<ID_LOADHELP>
- The About Command
- This command displays a message that tells you what
- the application is.
- ; -----------------------------------------
- <ID_FILENAME>
- [>>]<ID_FILES>
- The Filename Field
-
- On the Open File dialog box:
- Enter the name of the file you wish to
- open into a document window, or enter
- the file specification with wild cards
- to display a list of files in the
- [..Files]<ID_FILES> field.
-
- On the Save As dialog box:
- Enter the name with which you wish to
- save the file.
- ; -----------------------------------------
- <ID_FILES>
- [<<]<ID_FILENAME>
- [>>]<ID_DRIVE>
- The Files Field
- Select a file from the listbox by using one
- of these methods:
-
- Keyboard: Move the selection cursor to
- the file name and press Enter.
-
- Mouse: Double-click the file name.
- ; -----------------------------------------
- <ID_DRIVE>
- [<<]<ID_FILES>
- The Directories Field
- Use this listbox to select a different
- drive or subdirectory. Select a drive or
- subdirectory from the listbox by using one
- of these methods:
-
- Keyboard: Move the selection cursor to
- the drive or subdirectory and
- press Enter.
-
- Mouse: Double-click the drive or
- subdirectory.
- ; -----------------------------------------
- <ID_SEARCHFOR>
- [>>]<ID_REPLACEWITH>
- The Search For Text Entry Box
- Enter the text you want to search for in this
- text box. Press Enter or the OK command button
- to begin the search. Press Esc to forget it.
- Use the [..Match Upper/Lower Case Check Box]<ID_MATCHCASE> to
- select whether the search will match only if
- the case matches or if the search is insensitive
- to the case of the two strings.
- ; -----------------------------------------
- <ID_REPLACEWITH>
- [<<]<ID_SEARCHFOR>
- [>>]<ID_MATCHCASE>
- The Replace With Text Entry Box
- Enter the text string that will replace
- the matching text string in the
- [..Search For Text Entry Box]<ID_SEARCHFOR>.
- ; -----------------------------------------
- <ID_MATCHCASE>
- [<<]<ID_REPLACEWITH>
- The Match Upper/Lower Case Check Box
- Use this checkbox to select whether the search
- will match only if the case matches or if the
- search is insensitive to the case of the two
- strings.
- ; -----------------------------------------
- <ID_WINDOWLIST>
- The ID_WINDOWLIST Command
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <ID_TITLE>
- [<<]<Display?GA>
- [>>]<ID_BORDER>
- The Title Check Box
- Select this Check Box to toggle the application
- window's title on and off. Without a title, the
- window also loses its [..Control Box]<controlbox>.
- ; -----------------------------------------
- <ID_BORDER>
- [<<]<ID_TITLE>
- [>>]<ID_STATUSBAR>
- The Border Check Box
- Select this Check Box to toggle the application
- window's border on and off. Without a border, the
- window also loses its [..Status Bar]<statusbar>.
- ; -----------------------------------------
- <ID_STATUSBAR>
- [<<]<ID_BORDER>
- [>>]<ID_TEXTURE>
- The Status Bar Check Box
- Select this Check Box to toggle the application
- window's [..Status Bar]<statusbar> on and off.
- ; -----------------------------------------
- <ID_TEXTURE>
- [<<]<ID_STATUSBAR>
- [>>]<ID_COLOR>
- The Texture Check Box
- Select this Check Box to toggle the application
- window's background texture on and off.
- ; -----------------------------------------
- <ID_COLOR>
- [<<]<ID_TEXTURE>
- [>>]<ID_MONO>
- The Color Option Button
- Select this option for a color display.
- ; -----------------------------------------
- <ID_MONO>
- [<<]<ID_COLOR>
- [>>]<ID_REVERSE>
- The Mono Option Button
- Select this option for a monochrome display.
- ; -----------------------------------------
- <ID_REVERSE>
- [<<]<ID_MONO>
- The Reverse Option Button
- Select this option for a reverse monochrome
- display. You might find that this option
- works well with the LCD screens of some laptop
- computers, particularly when you turn off the
- [..Texture]<ID_TEXTURE> check box.
- ; -----------------------------------------
- <ID_LOGLIST>
- [<<]<Options>
- [>>]<ID_LOGGING>
- The Messages Listbox
- This is a list of D-Flat messages that
- you can log when the [..Logging]<ID_LOGGING> checkbox is
- selected. The list is a [..Multiple-Selection]<MultiSel>
- listbox.
- ; -----------------------------------------
- <ID_LOGGING> [<<]<ID_LOGLIST> The Logging
- CheckBox This checkbox turns message
- logging on and off. ;
- -----------------------------------------
- <TEXTBOX> The TEXTBOX Window Class
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <LISTBOX>
- The LISTBOX Window Class
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <EDITBOX>
- The EDITBOX Window Class
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <Pulldowns>
- [<<]<menubar>
- [>>]<File>
- Pull-down Menus
- Pull-down menus contain the commands to operate
- the program. Read about the [..Action Bar]<menubar> to see
- how to select the pull-down menus. Following
- is a list of the pull-down menus.
-
- [..The File Menu]<File>
- [..The Edit Menu]<Edit>
- [..The Search Menu]<Search>
- [..The Options Menu]<Options>
- [..The Window Menu]<Window>
- [..The Help Menu]<Help>
-
- The [..System Menu]<sysmenu> is another kind of pull-down menu.
- ; -----------------------------------------
- <File>
- [<<]<Pulldowns>
- [>>]<Edit>
- The File Menu
- The File menu contains commands that
- open, save, and print files. The menu
- also has the command that exits the
- program. Following are the commands
- and associated [**function keys]<shortcut>.
-
- [..New]<ID_NEW>
- [..Open]<ID_OPEN>
- [..Save]<ID_SAVE> (Alt+S)
- [..Save as]<ID_SAVEAS>
- [..Print]<ID_PRINT>
- [..Exit]<ID_EXIT> (Alt+X or Alt+F4)
-
- [**Inactive]<inactive> commands display in a dim font.
- ; -----------------------------------------
- <Edit>
- [<<]<File>
- [>>]<Search>
- The Edit Menu
- The Edit menu contains commands that support
- text editing. Following are the commands and
- associated [**function keys]<shortcut>.
-
- [..Undo]<ID_UNDO> (Alt+BS)
- [..Cut]<ID_CUT> (Shift+Del)
- [..Copy]<ID_COPY> (Ctrl+Ins)
- [..Paste]<ID_PASTE> (Shift+Ins)
- [..Clear]<ID_CLEAR>
- [..Delete]<ID_DELETETEXT> (Del)
- [..Paragraph]<ID_PARAGRAPH> (Alt+P)
-
- [**Inactive]<inactive> commands display in a dim font.
- ; -----------------------------------------
- <Search>
- [<<]<Edit>
- [>>]<Options>
- The Search Menu
- The Search menu allows you to search the text
- for a matching string. The commands are:
-
- [..Search]<ID_SEARCH>
- [..Next]<ID_SEARCHNEXT> (F3)
- ; -----------------------------------------
- <Options>
- [<<]<Search>
- [>>]<Window>
- The Options Menu
- The Options menu contains commands that let you
- control the editor's behavior, the video display
- characteristics, and whether to [**log]<logging> messages.
- You can save the options in a configuration file.
- Following are the commands on the Options menu.
-
- [..Insert]<ID_INSERT> (Ins)
- [..Word wrap]<ID_WRAP>
- [..Tabs]<ID_TABS>
- [..Display]<ID_DISPLAY>
- [..Log Messages]<ID_LOG>
- [..Save Options]<ID_SAVEOPTIONS>
- ; -----------------------------------------
- <Window>
- [<<]<Options>
- [>>]<Help>
- The Window Menu
- The Window menu has no selections unless the
- [..Application window]<Application> has one or more document
- windows displayed. When documents are displayed,
- the Window menu contains a [..Close All]<ID_CLOSEALL> command
- and an entry for the first nine document windows.
- You can select a document window from the Window
- menu. If the Application window has more than nine
- document windows, the Window menu has the [**More Windows]<MoreWins>
- command, which displays the [..Windows]<Windows> dialog box.
- ; -----------------------------------------
- <Help>
- [<<]<Window>
- The Help Menu
- The Help menu provides information about the
- application and the desktop. The selections are:
-
- [..Help for help...]<ID_HELPHELP>
- [..Extended help...]<ID_EXTHELP>
- [..Keys help...]<ID_KEYSHELP>
- [..Help index...]<ID_HELPINDEX>
- [..About...]<ID_ABOUT>
-
- ; -----------------------------------------
- <sysmenu>
- [<<]<Pulldowns>
- [>>]<ID_SYSRESTORE>
- The System Menu
- Most windows have a system menu. If the window has a
- System Menu, the window will have a [..Control Box]<controlbox>. You
- can select the System Menu by clicking the control
- box or by pressing Alt+Spacebar for the application
- window's system menu and Alt+Hyphen for the system
- menu of other windows.
-
- Following are the commands on the System Menu:
-
- [..Restore]<ID_SYSRESTORE>
- [..Move]<ID_SYSMOVE>
- [..Size]<ID_SYSSIZE>
- [..Minimize]<ID_SYSMINIMIZE>
- [..Maximize]<ID_SYSMAXIMIZE>
- [..Close]<ID_SYSCLOSE>
-
- ; -----------------------------------------
- <ID_SYSRESTORE>
- [<<]<sysmenu>
- [>>]<ID_SYSMOVE>
- The Restore Command on the System Menu
- This command restores a [..Minimized]<ID_SYSMINIMIZE> or [..Maximized]<ID_SYSMAXIMIZE>
- window to the size and position it had before it
- was minimized or maximized.
-
- You can also restore a minimized or maximized
- window by clicking its [..Restore Box]<restorebox>.
- ; -----------------------------------------
- <ID_SYSMOVE>
- [<<]<ID_SYSRESTORE>
- [>>]<ID_SYSSIZE>
- The Move Command on the System Menu
- The Move command lets you move a window with the
- keyboard. Select the command from the System Menu. A
- movable window frame comes into view over the
- window's border. Use the up, down, left, and right
- arrow keys to move the frame to the new window
- position. Press the Enter key when the movable frame
- is where you want to move the window. Press the Esc
- key to ignore the movement.
-
- You can move a window with the mouse by clicking on
- the window's [..Title Bar]<titlebar> and dragging the window to
- the new location.
- ; -----------------------------------------
- <ID_SYSSIZE>
- [<<]<ID_SYSMOVE>
- [>>]<ID_SYSMINIMIZE>
- The Size Command on the System Menu
- The Size command lets you re-size a window with the
- keyboard. Select the command from the System Menu.
- A sizeable window frame comes into view over the
- window's border. Use the up, down, left, and right
- arrow keys to change the frame to the new window
- size. Press the Enter key when the sizeable frame
- is the size you want for the window. Press the Esc
- key to ignore the size change.
-
- You can re-size a window with the mouse by clicking
- on the window border's [..Resize Box]<sizebox> and dragging the
- window to the new size.
- ; -----------------------------------------
- <ID_SYSMINIMIZE>
- [<<]<ID_SYSSIZE>
- [>>]<ID_SYSMAXIMIZE>
- The Minimize Command on the System Menu
- This command minimizes the window to an icon at the
- bottom of the application window.
-
- You can minimize a window with the mouse by clicking
- on the window's [..Minimize Box]<minbox>.
-
- The [..Restore]<ID_SYSRESTORE> command restores a minimized window to
- the size and position it had before it was
- minimized.
- ; -----------------------------------------
- <ID_SYSMAXIMIZE>
- [<<]<ID_SYSMINIMIZE>
- [>>]<ID_SYSCLOSE>
- The Maximize Command on the System Menu
- This command maximizes the window to occupy all of
- the application window's client area.
-
- You can maximize a window with the mouse by clicking
- on the window's [..Maximize Box]<maxbox>.
-
- The [..Restore]<ID_SYSRESTORE> command restores a maximized window to
- the size and position it had before it was
- maximized.
- ; -----------------------------------------
- <ID_SYSCLOSE>
- [<<]<ID_SYSMAXIMIZE>
- The Close Command on the System Menu
- This command closes the window with which the System
- Menu is associated.
-
- You can also close the window by double-clicking the
- [..Control Box]<controlbox> or pressing Ctrl+F4.
- ; -----------------------------------------
- ;
- ; Following are dialog box help windows
- ;
- ; -----------------------------------------
- <Dialog>
- [>>]<cmdbuttons>
- Dialog Boxes
- Dialog Boxes allow you to enter data into the
- application. A Dialog Box consists of these
- controls:
-
- [..Command Buttons]<cmdbuttons>
- [..Check Boxes]<checkboxes>
- [..Option Buttons]<optbuttons>
- [..Edit Boxes]<editboxes>
- [..List Boxes]<listboxes>
- [..Multiple-Selection Listboxes]<MultiSel>
-
- Move from control to control by using the Tab key
- or by pressing Alt+ the highlighted character in
- the control's label. Execute a control by pressing
- the Enter key.
-
- Exit the Dialog Box and accept its data entries by
- executing the OK command button.
-
- Exit the Dialog Box and reject its data entries by
- executing the Cancel command button.
- ; -----------------------------------------
- <cmdbuttons>
- [<<]<Dialog>
- [>>]<checkboxes>
- Command Buttons
- Select a command button to execute its
- command by using one of these procedures:
-
- 1. Click the button.
- 2. Press Alt+ the shortcut key.
- 3. Tab to the button and press Enter.
- ; -----------------------------------------
- <checkboxes>
- [<<]<cmdbuttons>
- [>>]<optbuttons>
- Check Boxes
- A check box can be on [X] or off [ ].
- Toggle the check box with one of these
- procedures:
-
- 1. Click the check box.
- 2. Press Alt+ the shortcut key.
- ; -----------------------------------------
- <optbuttons>
- [<<]<checkboxes>
- [>>]<editboxes>
- Option Buttons
- Option buttons are in groups of 2 or
- more. One option button in a group
- is on () and the others are off ( ).
- Select the option button with one of
- these procedures:
-
- 1. Click the option button.
- 2. Press Alt+ the shortcut key.
- ; -----------------------------------------
- <editboxes>
- [<<]<optbuttons>
- [>>]<listboxes>
- Edit Boxes
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <listboxes>
- [<<]<editboxes>
- [>>]<MultiSel>
- List Boxes
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <MultiSel>
- [<<]<listboxes>
- Multiple-Selection Listboxes
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <FileOpen>
- The File Open Dialog Box
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <SaveAs>
- The Save As Dialog Box
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <SearchText>
- The Search Text Dialog Box
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <ReplaceText>
- The Replace Text Dialog Box
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <MsgBox>
- The MsgBox Dialog Box
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <Display?GA>
- The Display Dialog Box
-
- ======== Text needed =========
-
- [..Title]<ID_TITLE>
- [..Border]<ID_BORDER>
- [..Status Bar]<ID_STATUSBAR>
- [..Texture]<ID_TEXTURE>
-
- [..Color]<ID_COLOR>
- [..Mono]<ID_MONO>
- [..Reverse]<ID_REVERSE>
-
- ; -----------------------------------------
- <TabStops>
- The Editor Tab Stops Dialog Box
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <Windows>
- The Windows Dialog Box
-
- ======== Text needed =========
-
- ; -----------------------------------------
- <Log>
- The Log Message Dialog Box
-
- ======== Text needed =========
-
- ; -----------------------------------------
- ;
- ; Following are keyword reference definition windows
- ;
- ; -----------------------------------------
- <inactive>
- An inactive menu command is one that is, for
- the moment, not available. The command becomes
- active at another time when conditions within
- the program require or permit its use.
- ; -----------------------------------------
- <shortcut>
- Function keys are key combinations that
- you can press to execute a menu command
- without selecting the pull-down menu
- itself. Not all menu commands have
- function keys. The most frequently used
- operations do.
- ; -----------------------------------------
- <logging>
- The message log is a debug tool. You should
- delete it from the system by turning off the
- INCLUDE_LOGGING global definition in dflat.h.
- You should then eliminate references to it in
- the MEMOPAD.TXT help database.
- ; -----------------------------------------
- <MoreWins>
- A menu can have only so many selections.
- The length of the screen is the limiting
- factor. The CUA standard defines nine
- windows as the maximum number of windows
- that the Window menu can display. The
- Windows menu has the More Windows command
- to provide a way for you to choose from
- the rest of the document windows.
- ; -----------------------------------------
- <API>
- Applications Program Interface (API):
- The functions, messages, macros, and
- data structures that a programmer
- uses to interface with the processes
- of a function library.
- ; -----------------------------------------
- <Block>
- Marking Text Blocks
- Marked text blocks affect the operation of these
- commands:
-
- [..Cut]<ID_CUT>
- [..Copy]<ID_COPY>
- [..Paste]<ID_PASTE>
- [..Clear]<ID_CLEAR>
- [..Delete]<ID_DELETETEXT>
- [..Paragraph]<ID_PARAGRAPH>
-
- Mark a text block by using one of these operations:
-
- Keyboard:
- ---------
- Hold the Shift key down and move the
- keyboard cursor. The block will be marked in
- reverse video.
-
- To clear the marked block, release the Shift
- key and press any text entry or cursor movement
- key.
-
- Mouse:
- ------
- Click on the first or last character of the
- block. Hold the mouse button down and move
- the mouse cursor around. The marked block
- will follow the mouse cursor.
-
- To clear the marked block, release the mouse
- cursor and click anywhere.
-
- ; -----------------------------------------
- <Clipboard>
- The Clipboard
- The Clipboard is a scratchpad where you can save
- text that can be pasted into a different location
- in the same or another document. You save text with
- the [..Copy]<ID_COPY> and [..Cut]<ID_CUT> commands, and you paste text into
- from the Clipboard into a document with the [..Paste]<ID_PASTE>
- command.
- ; -----------------------------------------
- <toggle>
- A toggle command is one that is
- either on or off. When it is on,
- its command on the menu is preceded
- by a check mark (√).
- <end>